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Yet Another Cross Assembler: PDP-ll 


We are turning the tables at last. When the 6502 was created 
six or seven years ago, programmers used PDP-1l development 
systems with cross assemblers to write 6502 code. Now you can 
use your Apple to write programs for the Digital Equipment 
Corporation's -ll family. Thanks to Martin Buchholtz for 
encouraging us to develop this one. He plans to use it for 
writing programs to run in DEC Falcon SBC-1ll based systems. 
Only $50, if you already own the S-C Macro Assembler. See our 
ad on page 16 for more about the Cross Assemblers. 


We Need Your Help 


Does anybody have complete details of the file format of the 
Apple ///'s relocatable object files? That's the last 
remaining stumbling block on the road to the S-C Macro 
Assembler ///. Has anyone figured it out yet? 


All Around the World 
We are now sending the Apple Assembly Line to subscribers in 32 


different countries. (That's about 1200 copies to the USA, and 
about 100 copies to the other 31 nations.) 


Displaying Character Generator EPROMS......Bob Sander-Cederlof 


We make our own Character Generator EPROMS for Revision 7 or 
later Apple II Plusses. I use the Mountain Hardware EPROM 
Burner to burn the data into 2716 EPROMS. We have several 
different character sets, and it can be a lot of trouble to 
check the results. 


After designing a character set, and formatting all the bits 
into the 2048 bytes of EPROM space, and burning it in, we still 
have to take an Apple apart and plug the chip in to see if all 
the characters look right. 


I decided to write a@ program which would map the EPROM data 
onto the hi-res screen, allowing me to test without wasting 
time burning/erasing EPROMs and dismantling/re-assembling my 
Apple. 


Even if you don't have the same requirements, you can learn a 
lot about indexing techniques and address shuffling from 
studying the following program. 


Starting at the top.... I set up three page-zero variables in 
lines 1040-1060. The S-C Macro Assembler is a great 
environment for making short programs like this one, because I 
can cycle through edit-assemble-test until it works just right 
without ever leaving the assembler. S-C Macro allows me to use 
zero-page locations $00-S1F without fear of inteference 
($OO-S1E in the Apple //e). 


Lines 1080 and 1090 define two buffers where I BLOAD two 
different EPROM images. I put one at $6800-6FFF, the other at 
$7000-77FF. There is room on the screen to display one 
character set in a 16x16 matrix on the left side, and the other 
on the right side. 


For grins, I decided to use the subroutine in Applesoft ROM at 
SF3E2 to turn on hi-res mode. This is the code executed for 
the HGR statement, so I called it AS.HGR at line 1110. HGR 
sets all the soft-switches to hi-res page 1, and clears the 
screen. 


Lines 1160-1180 call the HGR subroutine. Since I was using S-C 
Macro in the RAM card, and since the Applesoft ROMS are not 
switched on when a program is executing in the RAM card, I had 
a problem. The first time I tried to run DISPLAY, I left out 
lines 1160 and 1180. The result was a total disaster. Line 
1170 did a JSR S$F3E2 into the RAM card! I had to RESET and 
reboot the computer to get control again. Look out for these 
kinds of problems whenever you are trying to use code in both 
places at once. 


Lines 1190-1280 set up the starting addresses to display the 
first character set on the left half of the screen. Lines 
1290-1380 do the same job to show the second set on the right 
half-screen. 
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S-C Macro Assembler (the best there 18!) ....cccccccccccccccscesceese $80.00 

S-C Macro Assembler Version 1.1 Update....cccccsccsccccccssecccesseSl2.50 
For registered owners of the S-C Macro Assembler. 

Source code of S-C Assembler II, Version 4.0, on disk. .cccccccccee e $95.00 
Fully commented, easy to understand and modify to your own tastes. 

S-C Macro Assembler VAM A Torr re rere Le eee eT eee ee ee ee eee ot eel! 
Preliminary version. Call or write for details. 


S-C Cross Reference Utility Sine i eh 'S eRe Wi Wo Roo 02S OS ee eee 20s 00 
S-C Cross Reference Utility with Complete Source Code........0e0e2+950.00 


s-C word PLOCGSE BOL 666.66 66.6 6.6.6 6 WEES 0 WOW ERO ES OSES we ODN ZOU 
As is, with fully commented source code. Needs S-C Macro Assembler. 
Applesoft Source Code On DisSk..cccccccccesccccccvcsccccccvccccseceee es 90200 

Very heavily commented. Requires Applesoft and S-C Assembler. 
ES-CAPE: Extended S-C Applesoft Program EditoOr...cccccccccccccecess $00.00 


AAL Quarterly Di SKS eck hee Scie 6.65 he oe. 6 WSR ww wee ww oe OECD $15.00 
Each disk contains all the source code from three issues of "Apple 
Assembly Line”, to save you lots of typing and testing time. 


QD#l: Oct-Dec 1980 QD#2: Jan-Mar 1981 QD#3: Apr-Jun 1981 
QD#4: Jul-Sep 1981 QD#5: Oct-Dec 1981 QD#6: Jan-Mar 1982 
QD#7: Apr-Jun 1982 QD#8: Jul-Sep 1982 QD#9: Oct-Dec 1982 
QD#10: Jan-Mar 1983 


Double Precision Floating Point for AppleSOft....ccccccccccesccecss $50.00 
Provides 2l1-digit precision for Applesoft programs. 
Includes sample Applesoft subroutines for standard math functions. 


FLASH! Integer BASIC Compiler (Laumer Research) ...ccccccccccccccses $179.00 
Source Code for FLASH! Runtime Package... cccccccccccesvecccvecccees eS 39e00 
Full Screen Editor for S-C Macro Assembler (Laumer Research).......$49.00 


The Visible Computer: 6502 (Software Masters).......(reg. $50.00) $45.00 
Super Disk Copy III (Sensible Software).....cccccceee (reg. $30.00) $27.00 
Amper-Magic (Anthro-Digital) ..ccccccccccccsccccccces (YOGe $75.00) $67.50 
Amper-Magic Volume 2 (Anthro-Digital) eoevoveceeeneeece (reg. $35 -00) $30.00 
Quick-Trace (Anthro-Digital) ..cccccccccccccccccccsece (FEGe $50.00) $45.00 


DISASM Dis-Assembler (RAkK“WaLe) wecvceeceveteevccecsewcrscevcescesees 930.00 


Blank Diskettes (with hub rings)......ececcceeeee package Of 20 for $50.00 
Small 3-ring binder with 10 vinyl disk pages and disks........22+++936.00 
Vinyl disk pages, 6"x8.5", hold one disk each....ccccccceceeelO for $6.00 
Reload your own NEC PC-8023 ribbon cartridges...........each ribbon $5.00 
Reload your own NEC Spinwriter Multi-Strike Film cartridges....each $2.50 
Diskette Mailing ProtectorS...cccccccccccccccccseseelL0~-99: 40 cents each 

100 or more: 25 cents each 
ZIF Game Socket EX CON GEE 666.5 6550-05 ok 8 RA OC Ow ROSTERS OE CE eee 20.00 
Ashby Shift-Key MOG 655 oo 6 66a Ww hw SS a he 8 SES A Se Ee LO O00 
Lower -Case Display Encoder ROM oo 66 bere. oe OW WES CONE COR Ow OO 6 O8 OO 20e00 

Only Revision level 7 or later Apples. 


Grappler+ Printer Interface (Orange MicrO)....cccowceee ($175.00) $150.00 
Bufferboard 16K Buffer for Grappler (Orange Micro).....($175.00) $150.00 
Buffered Grappler+ NEW!! Interface and 16K Buffer..... ($239.00) $200.00 


BookS, BoOkS, BOOKE..ccccccccccccccccccccces compare our discount prices! 


"The Apple ][{ Circuit Description", Gayler.....2.eeee ($22.95) $21.00 
"Enhancing Your Apple II, vol. 1", Lancaster......... ($15.95) $15.00 
"Incredible Secret Money Machine", Lancaster......eeee ($7.95) $7.50 
"Micro Cookbook, vol. 1°, Lancaster...ccccccccceseecce ($15.95) $15.00 
"Beneath Apple DOS", Worth & Lechner...ccccccccccccee ($19.95) $18.00 
"Bag of Tricks", Worth & Lechner, with diskette......($39.95) $36.00 
"Apple Graphics & Arcade Game Design", Stanton....... ($19.95) $18.00 
"Assembly Lines: The Book", Roger Wagner....ccccecceee ($19.95) $18.00 
“what's Where in the Apple", Second Edition.......... ($24.95) $23.00 
"what's Where Guide” (updates first edition) .......... ($9.95) $9.00 
"6502 Assembly Language Programming”, Leventhal.....%($16.99) $16.00 
"6502 Subroutines", Leventhal ..ccccccccccccccccccsccce (9120699) $12.00 


Add $1 per book for US postage. 


Sf 
*#* S-C SOFTWARE, P. O. BOX 280300, Dallas, TX 75228 *** 
La dadial (214) 324-2050 aes 
*** We take Master Charge, VISA and American Express *** 
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Foreign orders add postage needed. 


The top line of hi-res page 1 starts at $2000, and goes to 
$2027. The middle of the line starts at $2014. The starting 
addresses of subseduent lines can be computed from these two 
base addresses, although it is a little tricky. More on this 
later. 


The hi-res screen shows the least significant seven bits from 
each byte. There are forty bytes in each line, making a total 
of 280 dots across. The dots in each byte are in reverse 
order: the least significant bit is the leftmost dot. On the 
Other hand, the EPROM image is in normal order. The subroutine 
DISPLAY.ONE.SET takes care of all the addressing, and 
REVERSE.BITS handles the reversals. 


Lines 1400-1410 pause until I hit any key on the keyboard. 
During this pause ‘I can examine the screen as long as I wish. 
When I type any key, the keyboard strobe will be set and $C000 
will go negative. Line 1420 will then clear the keyboard 
strobe, and the RTS at line 1430 returns to the S-C Macro 
Assembler. 


This brings us to a closer examination of the subroutine to 
actually display a character set, in lines 1440-1770. We will 
be displaying 16 rows of characters, with 16 characters in each 
row. It is therefore natural to simplify the problem by 
writing another subroutine to display one row of characters, 
and call it sixteen times. 


Lines 1480 and 1490 start a loop much like Applesoft's FOR I = 
1 TO 16...except in assembly language it is easier to go from 
16 to 1. The equivalent to NEXT I is at lines 1750 and 1760, 
where CNT16 is decremented. In between we have the body of the 
loop. 


Line 1500 calls DISPLAY.ONE.ROW, a subroutine that only gets 
called from this one line. I made it into a separate 
subroutine so I could put off writing it until later, and 
concentrate on one loop at a time. DISPLAY.ONE.ROW expects the 
addresses at SCREEN.ADR and EPROM.ADR to be already set up for 
the first byte to be displayed in the current row. After it 
returns, those addresses will have been modified. 


Lines 1510-1580 add 15*8, or 120, to the address in EPROM.ADR. 
DISPLAY.ONE.ROW already added 8, so the total augment is 128. 
This moves us up to the beginning of the next set of sixteen 
characters. 


Lines 1590-1740 assume that DISPLAY.ONE.ROW already added $2000 
to the address in SCREEN.ADR, and subtracts that value back 
out. At the same time, we add back in $80, to move to the next 
group of eight screen lines for the next row of characters. 
This is sufficient for the first eight rows of characters, but 
in moving to the ninth row there is a discontinuity which 
requires adding $28 and subtracting $400 to get the right 
address. The fact that the ninth row has arrived is apparent 
by the fact that the high byte of the address goes above $23 
(lines 1670 and 1680). 
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@ Eliminate the risk—rent first! 


e 100% of rental fee applies toward purchase 
e All purchases are 20% Off of Manufacturer’s 


Suggested List 


e Rentals are for 7-days (plus 3 days grace for return 


shipping) 
© No Membership Fees 
Now currently available for: 


Apple IBM, PC 

Eagle TRS-80 Il 

Northstar Osborne 
Franklin 


REMEMBER, THESE ARE NOT DEMOS, BUT ORIGINAL 
UNRESTRICTED SOFTWARE PROGRAMS 


(complete with manuals in original manufacturers’ packages) 
To Immediately Order, or for more information: 


UNITED COMPUTER CORP 
Software Rental Library 
Culver City, California 


*Pius postage and handling 


RENT SOFTWARE 
_ BEFORE YOU BUY! 


from our 


SOFTWARE 
RENTAL LIBRARY 


popular software available for just 
20-25% * of Manufacturers’ Retail Price 


MASTER i] MULTIPLAN | ' VISIFILE | : dBASE Ij | 


_; YALIWASHTOA 


TWNOISS3IONd YALIVAANIIBOS — +08 YIOVNVW 31d —) 1L93dNad VIVI 


— 


3 
Standard CP/M % 
Xerox 820 a 
Heath/Zenith 89 


Toll Free CALL 1-800 999-7777 
In California. CALL 1-800 992-8888 
In L.A. County CALL 1- 213 893- as 


AMERICAN 
| EXPRESS 33 


LO1d/GN3SULISIA _ Y3713dS JTSISN3SS IHL 


; FROGGER |) CHOPLIFTER [| GORF || DAVID’S MIDNIGHT MAGIC EASTERN FRONT (1941) - ZORK l 
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Here is a table of the starting addresses for each of the 24 
character rows (we only use the first 16): 


Row Address 


Row Address 


Row Address 


1 $2000 9 $2028 17 $2050 
2 $2080 10 $20A8 18 $20D0 
3 $2100 11 $2128 19 $2150 
4 $2180 12 $21A8 20 $21D0 
5 $2200 13 $2228 21 $2250 
6 $2280 14 $22A8 22 $22D0 
7 $2300 15 $2328 23 $2350 
8 $2380 16 $23A8 24 $23D0 


The starting addresses for the right half-screen can be 
obtained by just adding $14 to all of the above addresses. 
What we do is START at $2014, and all the rest are computed 
automatically. 


Now we can talk about what goes on inside one row of 
characters. Lines 1810-2000 do the job of moving bytes from 
the EPROM image to the eight screen lines which form the row of 
Characters. Lines 1820-1830 start a loop to count out eight 
repetitions, and lines 1980-1990 perform the NEXT on this loop. 


On each pass through the loop the subroutine GET.PUT is called 
sixteen times to move a byte for each character to the screen 
image. GET.PUT is another subroutine only called from one 
place, but made into a subroutine for ease of understanding. 
The inner loop of 0 through 15 is controlled by the X-register. 
Line 1850 sets X=0, and lines 1910-1930 increment, test, and 
branch (“NEXT X" sequence). The X-register also indexes the 
STA instruction inside GET.PUT, so that the screen byte for 
each character is stored into the right place on the screen 
line. The Y-register is used as an index into the EPROM data 
by GET.PUT, and parallels the X-register but with an increment 
of 8 rather than 1. Lines 1870-1900 bump the Y-register by 8 
each time through the inner loop. 


GET.PUT (lines 2230-2340) does the very simple job of moving 
one byte from one place in memory to another. Or is it so 
simple.... Notice that the addresses inside the LDA and STA 
instructions are filled in when the program runs. This is 
called self-modifying code, and I normally avoid such code at 
all costs. It can lead to all sorts of devastating things. 
Nevertheless, there are exceptions to most rules, and a time 
for nearly everything. This is one of those, I think. 
Isolating the offensive code into its own little subroutine 
appeases my conscience somewhat. 


In between LDA and STA I call REVERSE.BITS, yet another simple 
subroutine which could be written in-line. I prefer making it 
separate for nicer modularity. The comments show what is going 
on, bit-by-bit. If you were working from character generator 
data written for the DOS TOOL KIT or HIGHER TEXT, the bits 
would already be in the right order. It is just because I am 
using data for the character generator EPROM that we need to 
reverse the bits. 
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Here is a printout done with my NEC PC-8023 and a Grapplert 
interface card. The two character sets shown are the ones we 
sell. The one on the left uses regular lower case characters, 
with descenders. All the lower case characters are raised up 
one screen line to leave room for the descenders. The set on 
the right uses small caps for the lower case, and is the one we 
use in all the Apples here. The first four rows are the 
characters used in INVERSE mode, and the next four rows are for 
FLASH mode. (Doesn't flash too well on paper!) 


@ABCDEFGHI JKLMNO @ABCDEF CHI JKLMNO 
PORSTUUNXY ZEN J4_ PQORSTUUNXYZE\Ja4_ 

("8$%0'C 0E4,-.7 1° 8S$740'C VK¥4,-.7 
9123456789: ;<=>7 6123456789: ;<=>? 
@PABCDEFGHI JKLMNO @ABCOEF GH! JKLMNO 
PQ@RSTUVUWXYZE\J4_ PQRSTUUNXYZE\J4_ 

1" 8$7%%'C E+,—-.7 1° 8$740'C ¥+,-_7 
9123456789: ;<=57 9123456789: 5<=57 
@ABCDEFCHI JKLMNO @ABCDEFGHI JKLMNO 
PQRSTUUNKYZE\J4_ PQ@RSTUUNKYZEI\Ja4_ 

17 S$%8'¢ K+,—- 7 1° S$4se'¢ ¥+,- 7 
pigtarrcntucknne — SAREPECRT chad 
PQRSTUUWXYZE\ J4_ PORSTUUNXYZEN J4_ 
Yabcdefohijklano ‘ABCOEFGHIJKLMNO 
ParstuvexyuzZ{ i }-~» PeRSTUVNXYZ( 5} +e 


nee eg eee ee, per mek eae ree ae hee ere Ter eee ee 
e 
’ e 
é I t's here at last Please send me a PRAWM board g 
8 in the following configuration: é 
g | VM Configuration Qty Unit Price Total 4 
8 2K bytes «1204.95 i 
0 (8K byte non-volatile memory for Apple II;) ] te ae pine ote ott : 
: : 8K bytes 249.95 __ 8 

a : ho aera oe a ROM setts aaa board shipping & g 
te No battery backup required Be ecias 3 

e Off the shelf delivery stip To: : a 

e 1 year limited warranty oa 

e ee See eI Ee) 


Enable /disable under program control 
without (CFFF) 
e Data alterable 1 byte at a time 
e¢ No EPROM programmer necessary 
e No ultraviolet lights to erase 
e Auto start on power-up 
e@ 
@ 
e 


Please send: cert. check 
money order 
personal check 
VISA or MasterCard 
accepted 


Operates in any “Apple Il," peripheral slot 
On board firmware for block transfers 
Permanent storage of new commands, 
subroutines, utilities. 
e Multiple configurations: 2K, 4K, 6K, 8K bytes 
e User-expandable to 8K bytes 
¢ Compatible with Apple II+ and Apple Ile 
1. Apple Il is a registered trademark 
of Apple Computer. Cupertino. CA 


To order call 503-654-0611 or fill out order form: 


To: Advanced Peripheral Ent.. Inc. 
2617 S.E. Swain Ave. 
Milwaukie. OR 97222 

SHIP VIA: 


COD orders accepted 
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FASTDRAW 1.1 


A software package from CASTLE DESIGNS which provides enhanced 
Hi-Resolution Graphics instructions for use in Applesoft Basic 
programs. For example .... 


&DRAW,1 Erases, moves and re-draws an entire array 

of shapes with a single instruction. 
&HPLOT ,1 Erases, moves and replots an array of points. 
&HGR,c Performs a hi-speed screen erase to any color. 


Plotting rate exceeds 4,000 points per second. 


Other FASTDRAW 1.1 instructions provide scrolling, as well as 
drawing or plotting without erasing, Assembly language entry 
points are also provided. These new commands may be used to 
create fast-moving Basic games or to plot data quickly. 


This software may be used with the APPLIED ENGINEERING A/D 

BOARD to acquire and plot analog data. The A/D BOARD will 

acquire 8 channels of data with 8-bit resolution, and is very 

easy to use. Simply use a PEEK statement to read the data. 
APPLIED ENGINEERING A/D BOARD $129.00 


To acquire data with real-time accuracy, use the APPLIED 
ENGINEERING TIMEMASTER real time clock board in combination 
with the A/D BOARD and the FASTDRAW 1.1 software. The 
TIMEMASTER will provide timing for data acquisition as often 
as once per millisecond. For example, 200 data points can be 
acquired and plotted in 250 milliseconds. 

APPLIED ENGINEERING TIMEMASTER $129.00 


Included on the FASTDRAW 1.1 diskette are several programs 

which demonstrate its various uses and a utility which merges 

two shape tables. Special routines in both Basic and assembly 

language are provided which utilize the APPLIED ENGINEERING 

boards to acquire and plot data. Manual included. Requires 

Applesoft and DOS 3.3, and an APPLE II, II+, or IIe w/48K Ram. 
CASTLE DESIGNS FASTDRAW 1.1 ......... $29.95 


Texas Residents Add 5% Sales Tax (Hardware Only). 
Add $10.00 If Outside U.S.A. 


Order any of the above items from APPLIED ENGINEERING, P.O. 
BOX 470301, DALLAS, TEXAS 75247 ; Phone (214) 492-2027 


Or order FASTDRAW 1.1 from CASTLE DESIGNS, 2717 TEAKWOOD, 
PLANO, TEXAS 75075 


FASTDRAW 1.1 
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Receceeecteceocec cece oe se sows 
DISPLAY ONE ROW OF 16 CHARACTERS 
DISPLAY.ONE.ROW 
LDA 8 SCREEN LINES FOR ONE ROW 
STA CNT8 
o1 LDY #0 EPROM DATA INDEX 
LDX #0 SCREEN IMAGE INDEX 
22 JSR GET.PUT MOVE ONE BYTE TO SCREEN 
TYA ADD 8 TO EPROM DATA INDEX 
CLC 
ADC #8 
TAY 
INX BUMP SCREEN IMAGE INDEX 
CPX #16 
BCC .2 MORE CHARACTERS 
INC EPROM.ADR BUMP TO NEXT LINE OF EPROM 
LDA SCREEN.ADR+1 +$400 
ADC £2 ‘e RY = 1) 
STA SCREEN.ADR+ 
DEC CNT8 NEXT SCREEN LINE 
BNE .1 eee TF ANY 
; RTS RETURN 
sd REVERSE THE ORDER OF BITS 6-0 IN A-REG 
; (CHANGE XABCDEFG TO OGFEDCBA) 
REVERSE.BITS 
LSR REVERSE 7 BITS 
ee B A=OXABCDEF B=XXXXXXXG 
ton B A=OOXABCDE B=XXXXXXGF 
cE B A=OOOXABCD B=XXXXXGFE 
en B A=OOOOXABC B=XXXXGFED 
pen B A=O0O00OXAB B=XXXGFEDC 
fan B A=O000000XA B=XXGFEDCB 
roe : Az0000000X Bz=XGFEDCBA 
AND #$7F OGFEDCBA 
p RTS 
® PICK UP A BYTE OF EPROM DATA, 
# REVERSE THE BITS, AND STORE 
IT ON THE SCREEN. 
GET. PUT 


LDA $FFFF,Y 
EPROM.ADR .EQ &- 

JSR REVERSE.BITS 

STA $FFFF,X 
SCREEN.ADR .EQ #=2 

RTS 


Word Processor NOC C.i.c ose ooo ew Ge be ile oh see we eM LkKe Laumer 


We recently had one customer give us a great compliment on the 


S-C Word Processor. 


He has given up on WORDSTAR! He found 


that the S-C Word Processor can read and write large text files 
20 times faster than WORDSTAR and that scrolling was much 


quicker. 


He can be in and out of the S-C Word Processor before 
WORDSTAR even lets him type a single key. 


The S-C Word 


Processor is also much less expensive than WORDSTAR and you 
don't have to buy a Z-80 card! 


His only desire was to have an 80 column version of the Word 
Processor. 


However, that wouldn't be nearly so fast since SCWP 
re-writes the screen on every keystroke. 


I have noticed also 


that the 40 column display never causes me eye strain, but all 
the 80 column displays do. 
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QuicKkTRACE 


relocatable program traces and displays the actual machine operations, while it is running 
without interfering with those operations. Look at these FEATURES: 


Single-Step mode displays the last instruction, 
next instruction, registers, flags, stack contents, 
and six user-definable memory locations. 


Trace mode gives a running display of the Single- 
Step information and can be made to stop upon 
encountering any of nine user-definable 
conditions. 


Background mode permits tracing with no display 
until itis desired. Debugged routines run at near 
normal speed until one of the stopping cond- 
Itions is met, which causes the program to return 
to Single-Step. 


QUICK TRACE allows changes fo the stack, 
registers, stopping conditions, addresses to be 
displayed, and output destinations for all this 
information. All this can be done in Single-Step 
mode while running. 


Two optional display formats can show a sequence 
of operations at once. Usually, the information 
is given in four lines at the bottom of the screen. 


QUICK TRACE is completely transparent to the 
program being traced. It will not interfere with 
the stack, program, or I/O. 


QUICK TRACE Is relocatable to any free part of 
memory. its output can be sent to any slot or to 
the screen. 


QUICK TRACE is completely compatible with 
programs using Applesoft and Integer BASICs, 
graphics, and DOS. (Time dependent DOS 
operations can be bypassed.) It will display the 
graphics on the screen while QUICK TRACE is 
alive. 


QUICK TRACE Is a beautiful way to show the 


incredibly complex sequence of operations that 
a computer goes through in executing a program 


QuicKTRACE $50 


Is a trademark of Anthro-Digital, Inc. 
Copyright © 1981 
Written by John Rogers 


See these programs at participating Computeriland and other 
fine computer stores. 


Anthro - Digital Software, Inc. 
P.O. Box 1385 Pittsfield, MA 01202 
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Apple CI PS w.6's- 6 nals wards See Seek Ae eae ow os ee oe BOD and Bill 


4 


You may recall that when Bill reviewed Apple ][ Circuit 
Description last month, he bemoaned the lack of a "Cross 


Reference", by board location, of all the Apple's ICs. 


Well 


Bob has worked out a couple of tables to fill that gap, and 
we'll be including those tables in future shipments of the 


book. 


In the meantime, here's another sort of table, showing the 
locations and descriptions of all the chips in your Apple. 
This one is organized by chip number. 


Chip 


555 
558 
741 


2316B 
2513 
4116 
6502 
9316B 


74LS00 
74LS02 
74LS04 
74LS08 
74L811 
74LS 20 
74LS 32 
74LS51 
74LS74 
74LS 86 
74LS138 
74LS139 
74LS151 
74LS153 
74L8161 
74 166 
74LS174 
74LS8175 
74LS8194 
74LS195 
74L8 251 
74L8 257 
74LS 259 
74LS 283 
74LS 367 


8T97 
8T28 
8304 


Board 


Location (s) 


A5 


(Rev 7,RFI) 


Chip 
Description 


ROM (character generator) 


A5 (Rev 0,1) ROM (character generator) 
C3-10 D3-10 E3-10 RAM 

H6-9 Microprocessor 

F3-11 (6 chips) ROM (monitor and language) 
A2 4 2-input NAND 

Al2 Al4 B13 B14 4 2-input NOR 

Cll 6 Inverters 

Bll Al 4 2-input AND 

B12 3 3-input AND 

D2 2 4-input NAND 

C14 4 2-input OR 

C13 AND3-NOR2, AND2-NOR2 
All B10 J13 2 Flip-Flops 

B2 4 2-input XOR 

F12 F13 H2 H12 3-by-8 Decoder 

E2 F2 2 3-by-4 Decoders 

A9 l-of-8 Selector 

Cl Ell E12 E13 2 1-of-4 selectors 
D11-14 Counter 

A3 8-bit Shift Register 
B5 B8 6 Flip-Flops 

Bl 4 Flip-Flops 

Al0 B4 B9 4-bit Shift Register 
C2 4-bit Shift Register 
H14 l-of-8 Selector 

A8 B7 C12 Jl 4 l-of-2 Selectors 
F14 8-bit Addressable Latch 
E14 4-bit Full Adder 

H3 H4 4#H5 (on some models) 6 Bus Drivers 
H3 H4 4#H5 (on most models) 6 Bus Drivers 
H10 H1l (on rev 0,1,7) 4 Bus Buffers 
H10 (on ref RFI) 8 Bus Buffers 
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S-C CAPTURE -- A Modem Program for the Word ProceSSOr...cceceee 
Jim Church 


If you like to sign on to the The Source or CompuServe or some 
such system, you should get a copy of the S-C Word Processor. 

I like to receive the programs from CALL-A.P.P.L.E. magazine by 
modem and the S-C Word Processor really makes that easy. 


What you do is quite simple. Just put a copy of B.SC.CAPTURE 
on the disk with. the Word Processor. Then, whenever you want 
to capture a session with a remote system, you can choose D 
from the word processor menu and BLOAD B.SC.CAPTURE. After the 
routine is loaded, return to the main menu and choose L to load 
a sign-on file containing the commands necessary to dial the 
number you want to call. Here is a sample sign-on file, which 
I use to call up The Source. 


Ipr2 
O*367-6021 (The O is a Control-Q) 
Ipr768 


Now choose P from the menu, and your word processor will start 
dialing the phone! From here on you just operate the remote 
system as usual. The top line of the screen will show the 
address where characters are being stored, and the rest of the 
screen shows the text you are entering and receiving. 


When you want to quit, just type a Control Z to hang up your 

phone and return to the word processor's main menu. Select E 

and you will see a copy of everything that transpired. Now you 

arena the text however you want to, and save it all to your 
isk. 


The !pr768 command above is intended to provide a hook for a 
user-written printer driver. It sets the output hook at $36-37 
to $300. The next time the Word Processor tries to output a 
character, it wakes up the capture routine, which completely 
takes over until it is turned off with a Control Z. This is 
slightly abusing the !pr directive, so if you follow this 
example for other routines, be sure to have lines like 
1570-1590 at the beginning of your routine, and exit to $803 at 
the end, so the Word Processor can reconnect itself correctly. 


That's all there is to it. You could probably do a lot to 
"“smarten up" this dumb terminal program. The way I have done 
it, it recognizes a Control Z from the keyboard and filters out 
incoming Control J's. That's all it does. Probably it should 
filter out Control G too, at the very least. My intention is 
to demonstrate the simple fact that the word processor is a 
very versatile creature. 


This works, the way it is, with the D. C. Hayes Micromodem II 
in Slot 2. If your modem is in a different slot, just change 
line 1260 to show the correct slot number. 
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339- AD AG CO 1810 MODEM LDA MM.STATUS CHECK IF THE RECEIVER 
- 29 01 1820 AND #$01 REGISTER FULL BIT IS SET 
33E- FO DF 1830 BEQ TERMINAL NO, LOOP AGAIN. . 
3h0- AD A7 CO 1840 LDA MM.DATA YES, GET CHARACTER 
343- 99 86 1850 ORA et8o SET HI BIT 
45- CO BA 1860 CMP #$8A CONTROL J? 
347- FO D6 1870 BEQ TERMINAL IGNORE IT 
49-20 FO FD 1880 JSR COUT PRINT CHAR 
3hE- 91 00 1960 STA (PTR),Y CAPTURE IT IN BUFFER 
350- E6 09 1920 INCR INC PTR BUMP POINTER LO 
aef- Be Os i8ko INC PTR+1 BUMP POINTER HI 
336- A5 01 1950 LDA PTR+1 CHECK IF 
58- CO 96 1960 CMP #$96 BUFFER END? 
35A- BO 1B 1979 BCS QUIT FULL BUFFER, LEAVE 
35C- A5 24 1990 COUNT LDA CH SAVE CH 
35E- 2000 PHA ON STACK 
3BF- 49 09 3010 LDA #0 TOP LINE 
1- 26 2h FC 2020 JSR VTABZ FOR LOCATION COUNTER 
364- AQ 18 2030 LDA #$14 COL 20 
ooh. eg 5050 POA PERS1 HI BYTE OF LOCATION 
- + 
aee- 42 84 5020 LDX PTR LO BYTE 
36C- 20 41 F9 2070 JSR PRNTAX PRINT ADDRESS 
a70- 88 24 5090 STA CH OFd WHERE WE WERE OS 
Tor 38 33 Fe 8980 JSR VTAB OLD LINE 
375- 90 AS 2110 BCC TERMINAL START OVER 
-~A -:B130 QUIT LDA 0 END-OF-TEXT MA 
15- 7 88 $108 uP i (Eth) sy NOR ORD PROCESSOR 
= £9 05 2150 LDA $805 HANG UP PHONE 
D- AS CO 2160 STA MM.CR2 AT CONTROL REGISTER 
380- 4C 03 08 2170 JMP $803 COLDSTART WORD PROCESSOR 


OOoo0o SEeooeeooeeooceeo eoo0eco cCCCCOCCOCCCO 
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NEW from Laumer Research 
The S-C Macro Assembler Screen Editor. 


Powerful Screen Editor for assembler files, co-resident with 
the S-C Macro Assembler allowing screen editing when you want 
it and S-C Macro Assembler editing too. Loads in the unused 
4K bank of memory in a 16K Language Card. 


Includes SYSGEN program for configuring standard 40 column 
Apple, 80 column VIDEX, or 80 column STB80 video drivers. 
Ajustable tabs, margins, horizontal and vertical scrolling, 
lines to 248 columns, and much more... 


SOURCE code included. (Lets you learn about screen editors 
and configure for other brands of 80 column boards) 


Based on a popular TI 990 editor for software developers. 
NOTE: this is not a word processor editor. Organized just for 
computer languages. If you work with assembly programs of 100 
lines or more, then a Screen Editor is a MUST! 


Requires 64K APPLE II with Language card and S-C Macro 
Assembler Language Card Version 1.0. 


Price $49.00 from LAUMER RESEARCH 
1832 SCHOOL RD. 
CARROLLTON, TX 75006 


Master Card and Visa accepted (send Name, card number and exp. 
date). Foreign orders add $3.00 shipping (US funds only). 
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S-C Macro Cross Assemblers 


The high cost of dedicated microprocessor development systems has 
forced many techni'cal people to look for alternate methods to develop 
programs for the various popular microprocessors. Combining the 
versatile Apple II with the S-C Macro Assembler provides a cost 
effective and powerful development system. Hobbyists and engineers 
alike will find the friendly combination the easiest and best way to 
extend their skills to other microprocessors. 


The S-C Macro Cross Assemblers are all identical in operation to the 
S-C Macro Assembler; only the language assembled is different. They 
are sold as upgrade packages to the S-C Macro Assembler. The S-C 
Macro Assembler, complete with 100-page reference manual, costs $80; 
once’ you have it, you may add as many Cross Assemblers as you wish at 
a nominal price. The following S-C Macro Cross Assembler versions are 
now available, or -soon will be: 


Motorola: 6800/6801/6802 now $32.50 

6805 now $32.50 

6809 now $32.50 

68000 now $50.00 

Intel: 8048 now $32.50 

8051 now $32.50 

8085 soon $32.50 

Zilog: z~-80 now $32.50 

RCA: 1802/1805 now $32.50 

Rockwell: 65C02 now $20.00 

DEC: PDP-11/LSI-11 now $50.00 
The S-C Macro Assembler family is well known for its ease-of-use and 
powerful features. Thousands of users in over 30 countries and in 
every type of industry attest to its speed, dependablility, and 
user-friendliness. There are 20 assembler directives to provide 


powerful macros, conditional assembly, and flexible data generation. 
INCLUDE and TARGET FILE capabilities allow source programs to be as 
large as your disk space. The integrated, co-resident source program 
editor provides global search and replace, move, and edit. The EDIT 
command has 15 sub-commands combined with global selection. 


Each S-C Assembler diskette contains two complete ready-to-run 
assemblers: one is for execution in the mother-board RAM; the other 
executes in a 16K RAM Card. The HELLO program offers menu selection 
to load the version you desire. The disks may be copied using any 
standard Apple disk copy program, and copies of the assembler may be 
BSAVEd on your working disks. 


S-C Software Corporation has frequently been commended for outstandine 


support: competent telephone help, a monthly (by subscription, 
newsletter, continuing enhancements, and excellent upgrade policies. 


S-C Software Corporation (214) 324-2050 
P.O. Box 280300, Dallas, Texas, 75228 
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A PAUSE Directive. .ccccccccccccccccccccscccvcccceceeMike Laumer 


Maybe your source code has outgrown even two disks and you need 
to know when to swap disks during assembly. Maybe you're using 
a single-sheet printer and need to change pages. Maybe you 
want to change typefaces on your letter-quality printer. Maybe 
you want to check the address of a routine or variable, without 
having to constantly watch the screen until it comes along. 

For whatever reason, you need to have the S-C Macro Assembler 
pause during assembly. Here is a new .US directive to let you 
do just that! 


With this directive, you can insert a line like this anywhere 
in your code: 


1300 ~US SWAP SOURCE DISK 


In each pass, when the assembler encounters this line it will 
pause, display “SWAP SOURCE DISK" in inverse text at the bottom 
of the screen, beep twice, and wait for a keypress. You can 
take whatever action you need to, and press any key to resume 
assembly. 


The listing is for the Language Card version of the assembler. 
If you are using the main memory version, you don't need to 
worry about write-enabling and -protecting, so you can just 
delete lines 1220, 1230 and 1280. 


The values for the .EQ statements in lines 1170-1180 depend on 
whether you are using the Main Memory or the Language Card 
assembler, and whether you have Version 1.0 or 1.1. Here's a 
table of the values for US.VCTR and SC.CMNT: 


Main Language 


Memory Card Version 
US.VCTR $100C $SDOOC Both 
SC.CMNT S$1FD8 $E124 1.0 

S1FCA SEOE4 1.1 


That's all there is to it! Now you don't have to constantly 
stare at the screen during those long assemblies. Now you can 
sit back and wait for your Apple to call you when it needs you. 


1000 
io ae = -US DIRECTIVE TO PAUSE DURING ASSEMBLY 
1030 & SYNTAX: .US <phrase> 
1040 # RESULT: Displays <phrase> in inverse text 
1020 ad and walts for a keypress 
1060 # 
. 1070 Seedeewe cee ce cwese cee see cece 

OO7B- 1080 CHR.PTR .EQ $7B 

0200- 1090 UF -EQ $200 

O7D0- 1100 CORNER ~-EQ $7D0 

C000- 1110 KEYBOARD .EQ $C000 

C010- 1120 ROB -EQ $C010 

CO80- 1130 PROTECT .EQ $C080 

C083- 1140 ENABLE -EQ $C083 

FBE2- 1150 BELL ~-EQ $FBE2 
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Gna wm kteuo Fr wD Bm «6G 
Ceasrom CHARACTER SETS 


One of the features “hidden’ in many printers available today 

is their ability to accept user-defined character sets. With the 
proper software, these custom characters are downloaded’ from 
your Apple I1 computer to the printer in a fraction of a second. 
Once the printer has ’learned’ these new characters, they wil! 
be remembered until the printer is turned off. ° 


After the downloading operation, you can use your printer with 
virtuall>» any word processor. Just think of the possibilities! 
There’s nothing like having your own CUSTOM CHARACTERS to help 
convey the message. And you still have access to those built-in 
fonts as well! Here’s a quick look at some possible variations: 


BUILT-IN CUSTOM 
10CFI: AaBbCcDdEeFfGgHh!I i JjkKk AaBoCcHdE ef FOQHH 16 3 IKK 
12CPI: AaBbCcDdEeF FGgHh! i Jj Kk AaBbCcDd€ef FEQHH Ii) JK 
17CPI1: AaBbCcOdEeF fGqHh I] i J jKk Rodel cBdkef FC oth 1 i J jah 
SCPI: aabbCc Pde e FF AaBb Cac DAE ee & F 
6CPI: AMBaBbBbCcDdEeF fF RAabBbecCcDd€ ef F 
SCPI: AaBbCcDdEeF f AaBbC cDd€ ef F 


And jet’s not forget Enhanced and Underined printing as well... 


AaBbCcDdEeFfGgHh! i Jj Kk AabbCcDd€ef FEQHH1I 1S SKE 
AaBbCcDdEeFFfGqgHh! i Jj Kk AabbCcDdt ef FEQHE1 13 5JKK 


The Font Downloader & Character Editor software package has 

been developed by RAK-WARE to help you unleash the power of your 
printer. The basic package includes the downloading software with 
4 fonts to get you going. Also included is a character editor so 
that you can turn your creativity loose. Use it to generate unique 
character fonts, patterns, symbols and graphics. A detailed user’s 
guide is provided on the program diskette. 


SYSTEM KEQUIKEMNENTS: 

* APPLE II, APPLE II Plus, APPLE //e or loakalike with 48K RAM 

* ‘DUMB’ Parallel Printer Interface Board (like Apple’s Parallel 
Printer Interface, TYMAC’s PPC-100 or equivalent) 


The Font Downloader & Editor package is only $39.95 and is currently 
available for either the Apple Dot Matrix Printer or C.Itoh S5S10AP 
(specify printer). Epson FxX-80 and OkiData versions coming soon. 
Enclose payment with order to avoid $3.00 handling & postage charge. 


fF A HR —- WwW A HK «& 
41 Ralph Road West Orange New Jersey 07052 


Say You Saw It In APPLE ASSEMBLY LINE! 
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1160 
DOOC- 1170 US.VCTR .EQ $DO0C 
E124- 1180 SC .CMNT ~EQ oe 
ioe ~ -OR $300 
0300- AD 83 CO 1220 LDA ENABLE WRITE ENABLE 
0303- AD 83 co 1en5 LDA ENABLE RAM CARD 
030e- AQ 1 1240 LDA #PAUSE 
0308- 8D OD DO 1250 STA US.VCTR+1 POINT .US VECTOR 
O30B- AQ 03 1260 LDA /PAUSE 
030D- 8D OE DO ye STA US.VCTR+2 TO PAUSE ROUTINE 
03 10- AD 80 CO 1280 LDA PROTECT PROTECT CARD 
0313- 60 1230 ‘ RTS 
ee hee re te FB e000 eo ac” BEEP 
0319. AX 7B 1330 LDY CHR.PTR CHAR POINTER 
031B=- BY b6 02 1380 01 LDA WBUF,Y GET CHAR FROM CALL LINE 
O031E- FO OB 1350 BEQ .2 END OF LINE? 
0320- 29 3F 1360 AND #335 NO, INVERT CHAR 
03D2- 9D DO O7 1 Re STA CORNER,X AND PUT IT AT BOTTOM OF 
gio EB scneey 
0337- EO 28 1800 CPX #40 LINE FULL? 
0329- 90 FO eae BCC .1 NO, GET ANOTHER CHAR 
2B- 20 E2 FB 1430 .2 JSR BELL BEEP 
0358 AD 00 CO 1480 3 LDA KEYBOARD 
0331- 10 FB 1130 BPL 3a WAIT FOR KEYPRESS 
0335- 8p 10 CO 1460 STA STROBE 
0336- 4C 24 E1 te . JMP SC.CMNT RETURN TO ASSEMBLY 


WHY YOU NEED THE INSPECTOR. 


f you're serious about programming, you need 
papa eater paca an 

ide your Apple. The Inspector comes on an 
Eprom that simply plugs into the D8 socket, or on 


read and alter files, locate strings in memory or on 
disk. The uses are endless. The manual, alone, is an 
education. And it's always there when you need it. 
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a disk ready to merge with Integer Basic for 
automatic loading on boot. Either way, it stays at 
your fingertips, ready to call without disturbing 
your current program. 


he Inspector puts you in total control of both 
memory and disks. You can search forward 

and backwards, edit, read nibbles, 

map disk space, dump the screen 

to a printer, examine every secret 

of your Apple. Use The Inspector 

to repair blown disks, undelete 

files, input “illegal” commands, 


ou need the most powerful disk and memory 
utility available for your Apple. You need the 
Inspector. 


Ge pout local cate, or order ret for just 
$59.95. Mastercard and Visa holders order 
toll-free, 1-800-835-2246. ° 


OMEGA MICROWARE, INC. 
222 SO. RIVERSIDE PLAZA 
CHICAGO, IL 60606 
312-448-1944 


Apple isa registered trademark of Apple Computer. tnc 


Some New Cards 


1. Bob Stout just called from Houston to renew his 
subscription to AAL, and to tell me about a new toy he's 
getting. It seems that Legend Industries has a new kind of RAM 
card, containing 18K of static RAM, with battery backup. 


16K of the memory on the card is mapped just like a language 
card, so it can be used in slot 0. The card also has a 
hardware write-protect switch, that you can throw to compietely 
protect the memory. Once you have done that whatever you have 
stored in the card is there to stay. 


The card can also be used in a higher slot for boot-up 
operation. The other 2K of memory is mapped at SCNOO and 
$C800, just like. the ROM on a standard peripheral card. Think 
of the possibilities! 


This new card from Legend is available with either NiCad or 
Lithium batteries. This gives you a choice between 
rechargeability or very long power-off life (about 2 years). 
The price is $149.95. 


2. Saturn Systems has introduced a card with 64K RAM and a 
6502 on it. The CPU runs at 3.6 MHz, compared to Apple's 
roughly 1 MHz. Comes with a pre-boot disk to let you use this 
faster processor with Applesoft, Pascal, and Integer BASIC. 
Price is $599. See their ad in the latest Softalk Magazine. 


3. Analytical Engines, Inc. has one-upped the DTACK Grounded 
board. For only $1550, you can plug in an 8 MHZ 68000 card 
with 128K RAM (expandable to 512K on the card!). You can 
upgrade to a 12.5 MHz chip if you really need it. DTACK is NOT 
grounded on this board, so you have access to the full 
16-megabyte address space. The 16K ROM on the board contains 
monitor functions and diagnostics. YOu can replace the ROM 
with up to 64K of EPROM if you want. Software? The price 
includes a complete UCSD P-system (I think he said version 4.1) 
with Pascal, Basic, and Fortran compilers. You also get an 
Applesoft-compatible BASIC interpreter that runs entirely 
inside the 68000. CP/M-68 is optional, and Unix is supposed to 
be available soon. See their ad in the latest Nibble Magazine. 


4. Lee Meador has designed a board with 64K RAM, 4K EPROM, and 
a 2MHz 6502 on it. This unique board does not talk directly to 
the Apple bus; instead, there are two parallel ports (I presume 
implemented with a 6522 chip). One 8-bit port talks to the 
Apple I/O bus, and the other is available to outside devices. 
Software runs on the board at 2MHz, and at the same time your 
Apple chips do their 1MHz processing. I can think of a lot of 
neat ways to use Lee's board, including as a printer 
buffer/controller, as a high-speed math processor, as a hard 
disk interface, and so on. If enough of you are interested, 
Lee will sell these for around $500 each, along with some 
demonstration software. 
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FADD ~- Find ADDress referenceS....ccceccccceesee Brooke Boering 


Recently I have been messing around with modifications to DOS. 
Since I didn't have the complete source code for it, I simply 
used the explanations in “Beneath Apple DOS". I did find that 
I also needed a utility to locate all references to certain 
addresses. FADD was the result, and it's mighty useful. It's 
much quicker than doing a complete disassembly. 


FADD will locate all instructions within 64K of memory 
referring to a given address. It skips the S$COOO-SCFFF (1/0) 
pages and avoids missing memory by doing a double read test. 


It is intended to be used by the serious assembly language 
programmer for debugging and analysis. I'ts faster than doing 
a disassembly, though not quite so informative. 


FADD is origined at $300 (what else?) and uses 8 zero page 
locations that are generally unused by programs except as 
scratch. You can alter both the origin point and zero page 
locations to suit your individual needs. 


To use FADD: 
l- BLOAD B.FADD 
2- Get to Monitor 
3- ‘Fat finger’ your address into 6-7 in HI-LO order. 
4- Execute with a '300G' 


NOTE: Use the spacebar to pause/release listing. 


Teamed up inside \ 


[INTRODUCING Now THe INSPECTOR’ 
‘ 

our Apple, Watson | 

vdds pe features 


that give you complete | 


access to everything you ever 
wanted to know about memory jj.“ 


SY 

CY Eprom or disk versions are always at 
your . Watson (requires The 

7 apes): 49.95. The Inspector, 

$59.95. At ie local dealer or direct. 

MasterCard and Visa holders order 

toll-free. or return the coupon. 


1-800-835-2246 


ANCROVARE, INC. 
and disks. Recover blown disks, ? C) The Inspector @ 999 95 222 So. ivesode Feats 
fix catalog entries, display and delete ccf aon oe cereale 3m “acrrtg 


control characters, repair bad data files even 
on disks with non-nor DOS. Search forward and 
near in iomemory edit in HEX, ASCII, NEGATIVE ASCII 
and LOWE Scan disks forward and backwards, follow files 
forward ba Nhe tana in track/sector list on either 3. —  16- sector 
disks. Lockoet sectors on Track Bit recoastrect VFOC and display all 


| 

| 

| 

| 

| 

he ! 
Apple 1 “apple +O Integer Card) 16K Ram Card 0) 

; | 

: 

OC, fiad § | 

Track/Sector Lists, display of Sectors used on dish, read Nibbles track-by-track, f | 

taverse and characters, 
# | 
¢ | 


:O) : 
Apple is a registered trademark of Apple Computer. Inc 


a printer with a a CTRL-Z, even from withia BASIC. There’ more bat we're ¢ reaniag cut of 
Ob veil, you get the iden. 
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See eu ses ec ee 
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ORDER. 
Ccaeeoke 


Hi-bQ 
'300G' 


IN 
~a=> 


MONITOR 
‘FAT aha YOUR ADDRESS 


SE: 

LOAD FADD.OBJ 
ET TO 

INTO 6- 


NOTE --- 
K- EXECUTE WITH A 


~AQO 


ort 
Re NM 


"EQUATES | 


NORMAL LO/HI-BYTE 


REVERSES 
EASIER KEYIN FROM MONITOR 


Hee & EE 


OO90 00000000 6000 0900 099000 090 09000000000 SGOOSOOSCO OO O9OOSGO GOOG OOOO 0000 COSCO Coo oooo00o eo 
ON MET LO B&O DO NWP D NOS ORO MO AO © AMET LNW CO DS & OU ODE LOE ONS ON EPL BOD NO OME LAW P00 QO NMEA ONO 
9990 O90 00 00 OF MON CNT SD AT EP SPELT BF ET LAL LALILNID LAL UUW COO O00 (O19 100 Pe Be ee et Be Be P0060 C00 CO GD GOGO GOD CQUNHHAONAAADNO 


SOOT FF SEF CF CLV CH S&F FEE SS SS CE CF CF CLC CECE FEF EE ae ee ee eS CE CE CSE CFSE &CEF EE rer ee SP 2 C2 CE FCCCLSLK CEE OC 


AT BEGINNING 


OF MEMORY 
- CHECK FOR DIRECT REFERENCE 


START 


MEMORY HERE 


NO 
MEMORY AT THIS ADDRESS) 


SAVE TEMP 
Y GET IT AGAIN 
STILL THE SAME? 
io nee IT, 


Y GET WHERAT-LO 
NO 


0 
(THER), 
COLOR 
(WHER) 
COLOR 

FALL THROUGH 


Pi at <A) 
AAHALZ~ 


a ga hea 


2-BYTE MATCH ON TARGET) 


’ 
THROUGH 


co mwodr 
ON OOf 


WINOD = INO 
VAOMOA 


se00ns 
Naw how 
Sh ee ee aed od 
MM—MmM—ennr 
Ooooo0co 


= 
© 
eI fx] 
e~ = 
© ~ 
— = 
ae 
Be & = 
QO wo © 
= | 
os a] 
P >} © 
{23 = 
e ff fs = 
~~ oO Ee 
—Q “” 
'n = 
~ “ a 
3 
< & © 
A e 
n A 
oom < Es 
fs =1 3] = 
Or & a! 
a] 4 © 
<q oO Bie 
> > -4 
=) 
E102 
4 HO 
Mm Del 
[> ae -Y* 
“<q Wiis 
a mow 
-¥) Be 
«<< 
> PS fx] > 
| AABEI 
6 NWWIMOA 
Co oe 
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H INSTRUCTION) 


DISASSEMBLER ROUTINE 
- TEST IF BRANCHING TO TARGET 


AND SET PROGRAM COUNTER 


- CHECK FOR RELATIVE BRANCH 


>< 
Lead 
] f =) 
” = 
“2 <j 
(x3 
fz] (x3 f+ = ~ 
= a) A 
r= 4 ~~ a =z © 
= fee] < os | fe = oO ~~ 
am = = ca] fx fxs “” 
= UD fa ” © an | m9 Qon > a” a 
Oo A A (<3 > om | | Ee {3 ©] oO, & Oo %# © — gl 
mm <« © | | e& > VY oS (Qe. © uv) fs = re | 
& OO © ~E ” i oOo «a os] ae & NOW! Ons =: 
Qe. Ou Mo ” = ao aN wW«@ QQ «am Que IO 
a a | bj (x3 oo & ro | < = S Ym ae & 
© Rs E fa, <8 [+ — — & @ Bon as mo uu om a& 
ee Oo Oo Gx] fx, [ =) oO YQ O Rm OH fo Be CO G&G MoO “~ A bd 
| f& & QAA a a & Be “~ Beth aamw ZZ AMA H&rMOw 
= te 2 ag << F- = 2 s&s FT woe ANnAHR O Mei es 
Oo & OO bes) <& aa Zn O00 NOOO & SNe MWOnNOM 
a (f] Ae Om = A oOo BP AG | oO jo oe 
“” a bmi (©) = a < ~ ff aw we pt Aebtie om EY ont, As 
oOo win 1 <g a Oo x & ma Fm ft wy QOOuUr = ~~~ O 
Zz & ww Gad ed O pit HOM WOR HM HOr>S€¢ HOR Oo 
me AO GO Oe i= = Te NV A MeN BAH BS Mee el SH oe] 
vn © oO «@« fx po | oO 
=> ~ a => Se ~~ [- << 
~ << oO mA n A. 
eo §OF a he) BO FH m Hw «EH he Hx oO F | | 
W ws aro Q23 mG & a 00C«CMNdWdlC NWCA Cll a oS re 4 
e& mc WA © O © & TF Se F&F Oo &Ff- Oo & oO mo Or 
oO wAMRAI=t we ~ Gm a Of COC 8 8& SCOeO FF WwW & Z2MOo Am 
oe dE Oe Ay Mem By ° OH Hen HH NH DO OR BW RW SO BeBe a Bw ths © 
=z < A al «<Q Ary 4 
bé>4+ Pd bt bia: 86d bd x) D1 PS fx} Pt) Fee Oe Je FE Omogw <Q Ais fx] <G am (x) 
AARHAAN “222M 1 aA2aawH~ 6 Ga | 1 Qa ht b= -1 A I | &222 IASZaAHxSZ 
(' £TWIAINQNII9 BRHMHT 1 OmoOmM iw 9 i~mmme-mmma 1coHMHiM 1 JOM 1M 
oe Sm eo ] oB ss Se & Be eo ° Bie Be 


roa) c ooo CO 

faa fs Ooo oO oO 
CO OV<t OQ =—c010 - Mrwim oO omo omo COMnwD DAONADaAM 
COMmMoOON oO Oor-O- a CO- Che ONOO COUDADL 
WOTOTO-O aooed toto oO OoW OWoH WOwo INDO Cuno 
SEQDOOAEMN aA WADA N NEN vw HAW  <iOAdoA 
eeu eununn eos seen 8 00 00808 ae on i | ecoevenuen 
ONTOORED BWOrM Fn avey- ef S) mr tao fue MU OW) A fa 
stetaraatst sTINinKn LALA LOL wn INDO wim” OW = Ph 00 
MMMMC—AMO MmoNMMN mMmmoncnamn ~ MMM cMM—M Meam—en Mr—MO—M—ON 
DOCOCCO COCO vofololo) oO COO C0O ooo0°o CoOO000 


RETURN THROUGH CROUT 


JMP CROUT 


9 
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Generating Parity... .cccccccccccccccccccee es BOD Sander-Cederlof 


When large amounts of data are being moved around it is easy to 
garble some. When you transmit characters over the telephone, 
or read them from a tape or disk, you want some kind of 
assurance that the message does not get modified by the medium. 


Lots of schemes have been invented to prevent, detect, and even 
correct transmission errors: checksums, parity, cyclic 
redundancy codes, and more. 


Checksums are used inside the Apple all the time. If you ever 
used cassette tapes with your Apple, you were re-assured to 
know that each program was recorded with a checksum. DOS 3.3 
adds a checksum to the end of every sector on the disk. The 
checksum is re-computed when you read a tape or disk sector; if 
the result is different, at least one bit in the data is wrong. 


Most of the checksums I have seen are of the exclusive-or type. 
All the bytes in the data record are EORed together, and the 
result is written at the end of the record. When the data is 
read, the in-coming bytes are again EORed together, and finally 
EORed with the checksum itself. If the final result is 
non-zero, an error occurred. 


Checksums in the Apple are usually one byte wide. However, for 
more security, you could form a wider checksum. Or you could 
ADD the bytes together and store a two byte sum. Or store the 
complement of the sum, so that adding all the bytes plus the 
complement will give a zero result if there are no errors. 
[Checksums may check out OK even though errors occur, if the 
errors are sneaky enough to cancel each other out.] 


Parity is really a kind of checksum, but only one bit wide. A 
series of bits is EORed together, and the single-bit result is 
the parity value. In an ASCII character there is provision for 
the leading bit position to be used for storing a parity bit. 
An eight-bit byte holds seven data bits plus a parity bit. 


There are two kinds of parity in use: even and odd. Even 
parity makes the total number of l-bits in the stream of bits 
even; odd parity makes the total number of l-bits odd. Both 
even and odd are in use today in various kinds of equipment. 
Many terminals and serial communication boards allow you to 
select even, odd,-or no parity. Looking at the ASCII code for 
a couple of letters, each could be transmitted in four ways: 


Letter "M" 0100131041 -- No parity, 8th bit always 0 
1100311041 - No parity, 8th bit always 1 
01001101 -- Even parity 
11001101 -- Odd parity 

Letter "Q" 01010001 -- No parity, 8th bit always 0 
1103100041 -- No parity, 8th bit always l 
11010001 -- Even parity 
01010001 -- Odd parity 
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Sometimes I have needed a quick way to generate or verify a 
parity bit with software. These matters are usually handled in 


hardware, but not always. 


In the 6502, it is a very simple matter to rotate a byte around 
and count the number of one bits present. Then the parity bit 
can be merged with the byte, or compared with what is already 
there. 


The following subroutine (PARITY) computes the parity bit and 
merges it with the data byte. Call PARITY with the character 
to be merged in the A-register. Only the seven data bits will 
be counted. As written, the subroutine computes an odd parity 
bit. You can change line 1030 to “LDX #0*° to compute even 
parity. 


1000: *%4=——-==$=$S45553$2=5-3=-===->==— 

1010 * Compute and merge parity bit 

1020 Berm n nr rm nme en renee enna 

1030 PARITY LDX #1 (#0 FOR EVEN PARITY) 

1040 ASL SHIFT PARITY POSITION OUT 
1050 PHA SAVE SHIFTED CHARACTER 

1060 .1 BPL .2 IF NEXT BIT = 0, DON'T COUNT 
1070 INX IF NEXT BIT = 1, COUNT IT 
1080 .2 ASL SHIFT IN NEXT BIT 

1090 BNE .l IF ANY REMAINING BITS = 1 
1100 TXA GET COUNT OF 1-BITS 

1110 LSR EVEN/ODD BIT OF COUNT INTO CARRY 
1120 PLA ORIGINAL CHAR BUT SHIFTED 
1130 ROR SHIFT PARITY BIT INTO BIT 8 
1140 RTS 


I wrote a little program to drive the PARITY subroutine, using 
all possible values from 0 through 127, and print out the 
results: 


1150 *--------------~----------------- 
1160 PRHEX .EQ $FDDA MONITOR PRINT (A) IN HEX 
1170 COUT .EQ $FDED MONITOR PRINT CHAR IN (A) 


L1LO0  tesS=S$s5eSe=-S<=5$— SS =S=SS=5——= 

1190 DEMO LDA #0 FOR CHAR = $00 TO S$7F 

1200 STA CHAR 

1210 .1 JSR PARITY CALL THE PARITY SUBROUTINE 
1220 JSR PRHEX PRINT THE CHARACTER . 

1230 INC CHAR NEXT CHAR 

1240 LDA CHAR SEE IF TIME FOR A NEW LINT 
1250 AND #$07 

1260 BEQ .2 YES 

1270 LDA #$A0 <SPACE> 

1280 BNE .3 ee eALWAYS 

4290 .2 LDA #$8D <RETURN> 

1300 .3 JSR COUT PRINT SPACE OR RETURN 

1310 LDA CHAR 

1320 BPL .1 STILL LESS THAN $80: 

1330 RTS DEMO FINISHED 
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When I set it up for odd parity, here is part of the table 
printed out by DEMO: 


80 01 02 83 04 85 86 07 
08 89 8A OB 8C OD OE 8F 
10 91 92 13 94 15 16 97 


F8 79 7A FB 7C FD FE 7F 


Now, how about a subroutine to check parity? Here is a version 
that checks an 8-bit value for odd parity. Simply change line 
1420 to "LDX #0" to check for even parity instead. The 
subroutine returns with CARRY CLEAR for good parity, or CARRY 
SET for bad parity. 


1400 *-----------~-~---~-~~- aerenerare 

1410 CHECK. PARITY 

1420 LDX #1 (OR #0 FOR EVEN PARITY) 
1430 PHA SAVE ORIGINAL CHAR 

1440 .1 ASL SHIFT NEXT BIT INTO CARRY 
1450 BEQ .2 NO REMAINING 1-BITS 

1460 BCC .1 LEADING BIT NOT 1-BIT 

1470 INX COUNT THE 1-BIT 

1480 BCS .1 -- -ALWAYS 

1490 .2 BCC .3 LATEST SHIFTED BIT WAS 0 
1500 INX LATEST SHIFTED BIT WAS 1 
1510 .3 TXA BIT COUNT 

1520 LSR SHIFT EVEN/ODD BIT INTO CARRY 
1530 PLA RESTORE ORIGINAL CHARACTER 
1540 RTS 


APPLE'S CAPABILITY 


TIRED OF TURNING OPF YOUR APPLE TO ESCAPE PROM OTHER PINE CMW PRODUCTS 
A PROGRAM WHICH TAKES CONTROL OF YOUR COMPUTER? 

* SUPER CATALOG ROM - For use with PROM 
If you said yes, then the CMW PROM Switch (PS- Switch. Load, Verify, Run, Delete, Transfer, 
1) is for you. The PS=-1 ROM expansion board Lock, and Unlock files with two key stroke 
plugs into a motherboard ROM socket and allows operation. Runs in socket E8 - special 
you to switch between Apple ROMs and commercial versions for other sockets available upon 
or self programmed EPROMs. Used in socket SF8, request. Mode] CR-1] ..... $14.95 
you can switch between the Autostart Monitor, * The DISK SWITCR- Gives complete control of 
the older Apple J[{ Monitor, or a customized the write protect switch in your disk drive. 
monitor to easily set your own RESET vectors. Write on the backs of diskettes without cutting 
Used in other sockets, $D0 to SFO, even Apple a notch or disable any write enable regardless 
}{ Plus users can use programs like Omega of notch. Model DSK-1 ..... $11.95 
Microware's "Inspector" PROM, or Apple's * The PROMETTE - Allows you use EPROMs in any 
"Programmer's Aid*,. The PS-1 can use up to ROM socket directly. Model PC-1 ..... $4.95 
three Apple ROMs, 2716 S-volt EPROMs, or any *® The DOS SWITCH - The original one. Allows 
combination. Up to 4 PS-ls can be installed in convenient direct boot of either DOS 3.2 or 
your computer at one time giving you the 3-3- Model DS-1 ..... 95 
capability to switch-select 8 additional 2k 


ROM/EPROMS such as printer drivers, utilities, Add $2.00 - shipping. OH add 5.5% sales tax, 
etc. ROM/EPROMS not in use are turned off, VISA, MC, Check, COD (add $1.40). Write for 
minimizing power supply loading. Customers Our flyer on CMW products. 

appreciate the convenience of having their APPLE J{ is a registered trademark of Apple 
favorite utilites on line at the flick of a Computer, Inc. 


conveniently located toggle switch. Order from oe Computer Micro Works INc 


CMW direct: mention this Ad for a 15% discount. 
(offer good for 30 days from publication date). 
List Price ..... $49.95 


0.0. Bex 3365! Deyten, Ove 45433 
(305) 777-0268 (FL sales office) 
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Apple Peripherals Are All We Make 


That’s Why We’re So Good At It! 


The TIMEMASTER 
Finally, a clock that does it ALL! 


eo 


a8 


WHT 


Designed in 1983 using LC technologies that simply did not exist 

when most other Apple clocks were designed. 

Just plug it in and your programs can read the year, month, date, day, 

and time — down to 1 millisecond! 

Powerful 2K ROM driver — No clock could be easier to use. 

Full emulation of most other clocks, including Mountain Hardware’s 

Appleclock (but you'll like the TIMEMASTER mode better). 

Compatible with all of Apple's languages, CP/M and PASCAL software 

on disk. 

Eight software controlled interrupts so you can execute two programs 

at the same time. 

On board timer lets you time any interval up to 48 days long down to 

the nearest millisecond. 
The TIMEMASTER includes a disk with some really fantastic time 
oriented programs (over 25) plus a DOS dater so it will automatically add 
the date when disk files are created or modified. This disk is over a 
$200.00 value alone — we give the software others sell. All software 
packages for business, data base management and communications are 
made to read the TIMEMASTER. 


If you want the most powerful and the easiest to use clock for yourApple, 


you want a TIMEMASTER. PRICE $129.00 


Super Music Synthesizer 


Complete 16 voice music synthesizeron one card. Just plug it into your 
Apple, connect the audio cable (supplied) to your stereo, boot the disk 
supplied and you are ready to input and play sones. 

It's easy to program music with our compose software. You will start 
right away at inputting your favorite songs. The Hi-Res screen shows 
what you have entered in standard sheet music format. 

We give you lots of software. In addition to Compose and Play 
programs, the disk is filled with songs ready to play. 

Easy to program in Basic to generate complex sound effects. 

Four white noise generators which are great for sound effects. 

Plays music in true stereo as well as true discrete quadraphonic. 
Full envelope control. 

Will play songs written for ALF synthesizer (ALF software will not take 
advantage of all the features of this board. Their software sounds the 
same in our synthesizer.) 


Automatic shutoff on power-up or if reset is pushed. 
Many many more features. 


PRICE $159.00 


Z-80 PLUS! 


TOTALLY compatible with ALL CP/M software. 
Executes the full 2-80 and 8080 instruction set. 
Fully compatible with microsoft disks (no pre-boot required). 


@ An on-card PROM eliminates many 1!.C.’s for a cooler, less power 
consuming board. (We use the Z-80A at a fast 3.58 MHZ) 

@ Does EVERYTHING the other Z-80 boards do, plus Z-80 interrupts. 

@ All new 1983 design incorporates the latest in I.C. technologies. 

@ Complete documentation included. (User must furnish software) 


The Z-80 PLUS turns your Apple into a CP/M based computer. This 
means you can access the largest body of software in existence. Two 
computers in one and the advantages of both, all at an unbelievably low 
price. 


PRICE $139.00 


Analog to Digital Converter 


8 Channels 


e @ Eliminates the Need to Wait for 
@ 8 Bit Resolution 

e 

e 


A/D Conversion (just PEEK at data) 
@ A/D Process Totally Transparent 
to Apple (looks like memory) 


On Board Memory 
Fast Conversion (.078 ms per 
channel) 


The analog to digital conversion takes place on a continuous, channel 
sequencing basis. Data is automatically transferred to on board memory 
at the end of each conversion. No A/D converter could be easier to use. 


Our A/D board comes standard with 0, 10V full scale inputs. These inputs 
can be changed by the user to 0, -10V, or -5V, +5V or other ranges as 
needed. 


Information on temperature sensors is given in manual. 
The user connector has +12 and -12 volts on it so you can power your 
sensors. 


Accuracy 0.3% Input Resistance 20K Ohms Typ 


A few applications may include monitoring and control of @ flow 
@ temperature @ humidity @ wind speed @ wind direction @ light 
intensity @ pressure @ RPM @ storage oscilloscope @ soil moisture 
and many more. 


PRICE $129.00 


Digital Input/Output Board 


Provides 8 buffered outputs to a standard 16 pin socket for standard 
dip ribbon cable connection 


Power-up reset assures that all outputs are off when your Apple is 
turned on. 


Features 8 inputs that can be driven from TTL logic orany 5 volt source. 


@ Your inputs can be anything from high speed logic to simple switches. 

@ Very simple to program, just PEEK at the data. 

@ Now, on one card, you can have 8 digital outputs and 8 digital inputs 
each with its own connector. The super input/output board is your 
best choice for any control application. 


PRICE $62.00 


Our boards are far superiornto mostolthe consumerelectronics made today. All LC.’s are in high quality sockets with mil-spec. components used throughout. P.C. boards are 


glass-epoxy with gold contacts: Made in 


merica to be the best in the world. All products work in APPLE He, UI and I+ 


Applied Enginecring’s products are fully tested with Complete documentation and available for immediate delivery. All products.are guaranteed with a no hassle two year 


warranty. 


Send Check or Money Order to: 


All Orders Shipped Same Day 
Texas Residents Add 5% Sales Tax 
Add $10.00 If Outside U.S.A. 


APPLIED ENGINEERING 
P.O. Box 470301 
Dallas, TX 75247 


Call (214) 492-2027 
7am to 11pm 7: days a week 
MasterCard & Visa Welcome 
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ROGRAM TOO LARGE 22 2 eo oso. 6 6400 606 Whee 6 SS be 0 66 66 oe owe eee LCS Meador 


I was writing an ampersand file-handling routine, using the 
File Manager in DOS as described in chapter 6 of Beneath Apple 
DOS. I wanted my Applesoft program to be able to set ONERR and 
catch errors in files (wrong name, too Short, etc.) But I also 
wanted the error messages to come out in immediate mode or with 
no ONERR set. Since I was doing my own file-handling, I was 
going to have to provide my own error outputs. Originally I 
tried this: 


ERROR LDY #S0A error code offset 
LDA ($04) ,Y $04 -> FM parmlist 
JMP SA6D2 jump into DOS error handler 


This worked OK when used in code that was called from an 
Applesoft program, but when I called it*in immediate mode (from 
the *])") I would always get “ROGRAM TOO LARGE" when an error 
occurred, 


You might guess that I have found a solution. The problem is 
caused when we jump into DOS at $A6D2 with the IO hooks still 
pointing into DOS. The routine starting at S$A6D2 saves the 
error code in a temporary location at SAA5C and calls $A702 to 
print a "<return><beep><return>". Since we entered illegally 
that output goes to DOS at S$9EBD, then via a JSR to $9ED1 where 
the accumulator is saved in a temporary location -- SAASC! 

This leaves that last <return> in SAASC. 


When control returns to the error handler DOS then tries to 
look up error message number 141 ($8D) in the 16-entry table of 
offsets starting at SAA3F. This loads the offset from location 
SAACC, which happens to contain the high-order byte of the 
address of the OPEN command handler ($AB22)! This leaves the 
error message printer with an offset of SAB into the messages 
at $A971. And that is what produces “ROGRAM TOO LARGE". Look 
at the routines at SA6D2 and $A702 for more detail. $A702 is 
meant to be called with the error code in the X register. 


Now here's a method to have the error handled correctly: 


OUT.HOOK .EQ $36 
HARD.COUT .EQ S$FDFO 


ERROR LDA #HARD.COUT point hook out of DOS 
STA OUT.HOOK 
LDA /HARD.COUT 
STA OUT.HOOK+1 DOS will fix it back 


LDY #S0A index to error code 
LDA ($04) ,Y $04 -> FM parmlist 
JMP SA6D2 do it ... 
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